1. Unpack the AutoRank archive that you downloaded, using directory names.

2. Open all of the files that have a .cgi extension in a text editor. You will need to set the location of Perl 5 on your server. This is done on the first line of the file:

   #!/usr/bin/perl

   Change the /usr/bin/perl value to match your system's setup. If you have telnet access you can locate perl by typing the following command:

   which perl

   In most cases, /usr/bin/perl or /usr/local/bin/perl is a valid setting. Note that this must point to Perl 5. Ask your server administrator if you are unsure about the perl location.

3. Login to your FTP server, and change into the directory where you will be installing the CGI scripts. (We recommend that this directory be inside a cgi-bin or equivalent directory) In that directory, create 3 more directories. Name them data, sdata, and templates. These directories will contain all of the files that control script operation. The HTML files that the script creates (the files that contain the list) will need to be in a seperate directory located outside of the cgi-bin.

4. Now, upload all of the .cgi files to the directory that you want them installed in. Make sure that you are uploading in ASCII mode. Next, upload the errors.dat, header.txt, and footer.txt file to the sdata directory that you created - again in ASCII mode. Finally, upload all of the .htmlt files to the templates directory that you created - in ASCII mode.

5. You will now need to set permissions on the files you uploaded, and directories that you created. Below you will see a table with recommended permissions settings. These settings should work for most servers, however others may require different settings.

   File or Directory Permissions All .cgi Files 755 errors.dat 644 header.txt 644 footer.txt 644 sdata 777 data 777 templates 755 All .htmlt Files 644 Directory where list HTML files will be written 777

   Example Directory Structure
   /home/username/cgi-bin/autorank                   location of .cgi files
   /home/username/cgi-bin/autorank/sdata             location of script data files (admin.dat, errors.dat)
   /home/username/cgi-bin/autorank/data              location of member data files (created by script)
   /home/username/cgi-bin/autorank/templates         location of all template files
   /home/username/public_html/toplist              where the list HTML files will be written
   

6. You are now ready to begin the WWW based portion of the setup. In your browser, type in the full URL to the setup.cgi file on your server. This will bring up the portion of the script where you will set all of the variables. Details and examples for each variable are given, so follow along through that to get all of the variables set properly.

   After you have set all of the variables, enter the default password admin and click the button. If everything went well, you will be presented with a page telling you that the variables have been recorded. To do further verification of your settings you can call the setup.cgi script like setup.cgi?verify. This will preform a series of tests and report the results.

7. You should now be ready to begin using the scripts.

Other Installation Notes

• You will need to provide a link to the page where webmasters can add their site when you edit the header and footer files for your list. Somewhere in the header/footer place a link that points to accounts.cgi so people can add their site.

• Use the header.txt and footer.txt files to add HTML above and below the ranking list. All HTML that you put in header.txt will appear above the list, all HTML you put in footer.txt will appear below the list.

Templates

This feature is implemented in v2.0.0, however it is still in development stages. We will not be adding documentation until it is complete, so if you want to edit the template files you will be doing so at your own risk!